创建 Balance Bonus 对象

发起一次赠送请求时需要创建一个新的 balance_bonus 对象。

请求参数描述
APP_ID required string对应 app 对象的 id,该参数仅需要填写在请求地址内,查看 如何获取App ID
amount required int受赠金额,单位为分。
user required string受赠的 user 对象的 id
order_no required string商户订单号,必须在商户的系统内唯一,64 位以内。
description optional string附加说明,最多 60 个 Unicode 字符。
metadata optional hash详见 元数据

返回

返回一个 balance_bonus 对象,或者一个错误,详见 错误

定义

POST https://api.pingxx.com/v1/apps/{APP_ID}/balance_bonuses
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/balance_bonuses \
-H "Pingplusplus-Signature: {SIGNATURE}" \
-H "Pingplusplus-Request-Timestamp: 1496728534" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC: \
-d {
	"amount": 1000,
	"user": "test_user_001",
	"order_no": "2017071110258972"
	"description": "余额赠送描述"
}
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
  "id": "311317071315160600000100",
  "object": "balance_bonus",
  "app": "app_1Gqj58ynP0mHeX1q",
  "created": 1496728534,
  "livemode": false,
  "paid": true,
  "refunded": false,
  "amount": 100,
  "amount_refunded": 0,
  "time_paid": 1496728594,
  "user": "user_007",
  "order_no": "2017071110258972",
  "balance_transaction": "310317060612081500000501",
  "description": "余额赠送",
  "metadata": {}
}